Node / meshtastic / Meshtastic-Android / files / feature / docs / src / commonTest / kotlin / org / meshtastic / feature / docs / DocImageWiringTest.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.feature.docs

Tff7b72import T7ee787kotlinx.coroutines.test.runTest

Tff7b72import T7ee787meshtasticandroid.feature.docs.generated.resources.Res

Tff7b72import T7ee787org.meshtastic.feature.docs.data.DefaultDocBundleLoader

Tff7b72import T7ee787org.meshtastic.feature.docs.ui.resolveDocImageResourcePath

Tff7b72import T7ee787kotlin.test.Test

Tff7b72import T7ee787kotlin.test.assertEquals

Tff7b72import T7ee787kotlin.test.assertNull

Tff7b72import T7ee787kotlin.test.assertTrue

T8b949e/**

* Guards the docs image pipeline end to end: every image referenced by a bundled markdown page must resolve (via the

* same path mapping the in-app renderer uses) to a real bundled compose resource. Catches broken aliases, missing

* screenshot assets, and regressions in the markdown-path-to-resource mapping.

*/

Tff7b72class T56d364DocImageWiringTest Tb4b4b4{

Tff7b72private Tff7b72val Te6edf3loader Tff7b72= Te6edf3DefaultDocBundleLoaderTb4b4b4(Tb4b4b4)

Tf0883e@Test

Tff7b72fun Td2a8ff`relative asset links resolve to the bundled screenshots directory`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3assertEqualsTb4b4b4(

Ta5d6ff"Ta5d6fffiles/docs/assets/screenshots/nodes_node_list.pngTa5d6ff"Tb4b4b4,

Te6edf3resolveDocImageResourcePathTb4b4b4(Ta5d6ff"Ta5d6ff../../assets/screenshots/nodes_node_list.pngTa5d6ff"Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`root-relative asset links resolve to the bundled screenshots directory`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3assertEqualsTb4b4b4(

Ta5d6ff"Ta5d6fffiles/docs/assets/screenshots/foo.pngTa5d6ff"Tb4b4b4,

Te6edf3resolveDocImageResourcePathTb4b4b4(Ta5d6ff"Ta5d6ff/assets/screenshots/foo.pngTa5d6ff"Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`external links are not transformed`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3assertNullTb4b4b4(Te6edf3resolveDocImageResourcePathTb4b4b4(Ta5d6ff"Ta5d6ffhttps://example.com/x.pngTa5d6ff"Tb4b4b4)Tb4b4b4)

Te6edf3assertNullTb4b4b4(Te6edf3resolveDocImageResourcePathTb4b4b4(Ta5d6ff"Ta5d6ffhttp://example.com/x.pngTa5d6ff"Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`every image referenced by a bundled page resolves to a bundled resource`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3bundle Tff7b72= Te6edf3loaderTb4b4b4.Te6edf3loadTb4b4b4(Tb4b4b4)

Tff7b72val Te6edf3imagePattern Tff7b72= Te6edf3RegexTb4b4b4(Ta5d6ff"""Ta5d6ff!Ta5d6ff\Ta5d6ff[[^Ta5d6ff\Ta5d6ff]]*]Ta5d6ff\Ta5d6ff(([^)Ta5d6ff\Ta5d6ffs]+)Ta5d6ff\Ta5d6ff)Ta5d6ff"""Tb4b4b4)

Tff7b72val Te6edf3missing Tff7b72= Te6edf3mutableListOfTff7b72<Tffa657StringTff7b72>Tb4b4b4(Tb4b4b4)

Tff7b72for Tb4b4b4(Te6edf3page Tff7b72in Te6edf3bundleTb4b4b4.Te6edf3pagesTb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3markdown Tff7b72= Te6edf3loaderTb4b4b4.Te6edf3readPageTb4b4b4(Te6edf3pageTb4b4b4.Te6edf3idTb4b4b4)Tff7b72?.Te6edf3markdown Tff7b72?: Tff7b72continue

Tff7b72for Tb4b4b4(Te6edf3match Tff7b72in Te6edf3imagePatternTb4b4b4.Te6edf3findAllTb4b4b4(Te6edf3markdownTb4b4b4)Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3link Tff7b72= Te6edf3matchTb4b4b4.Te6edf3groupValuesTff7b72[T79c0ff1Tff7b72]

Tff7b72val Te6edf3resourcePath Tff7b72= Te6edf3resolveDocImageResourcePathTb4b4b4(Te6edf3linkTb4b4b4) Tff7b72?: Tff7b72continue

Tff7b72val Te6edf3exists Tff7b72= Te6edf3runCatching Tb4b4b4{ Te6edf3ResTb4b4b4.Te6edf3readBytesTb4b4b4(Te6edf3resourcePathTb4b4b4)Tb4b4b4.Te6edf3isNotEmptyTb4b4b4(Tb4b4b4) Tb4b4b4}Tb4b4b4.Te6edf3getOrDefaultTb4b4b4(Tff7b72falseTb4b4b4)

Tff7b72if Tb4b4b4(Tff7b72!Te6edf3existsTb4b4b4) Te6edf3missing Tff7b72+Tff7b72= Ta5d6ff"Tffd700${Te6edf3pageTb4b4b4.Te6edf3idTffd700}Ta5d6ff: Tffd700$Te6edf3linkTa5d6ff -> Tffd700$Te6edf3resourcePathTa5d6ff"

Tb4b4b4}

Tb4b4b4}

Te6edf3assertTrueTb4b4b4(Te6edf3missingTb4b4b4.Te6edf3isEmptyTb4b4b4(Tb4b4b4)Tb4b4b4, Ta5d6ff"Ta5d6ffUnresolvable doc images:Ta5d6ff\Ta5d6ffnTffd700${Te6edf3missingTb4b4b4.Te6edf3joinToStringTb4b4b4(Ta5d6ff"\Te6edf3nTa5d6ff"Tb4b4b4)Tffd700}Ta5d6ff"Tb4b4b4)

Tb4b4b4}

Tb4b4b4}